home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 May: Tool Chest / Developer CD Series Tool Chest (Apple Computer)(May 1999).iso / Tool Chest / Development Kits / MPW etc / MPW-GM / MPW / Examples / Projector Examples / Instructions
Encoding:
Text File  |  1998-12-03  |  4.9 KB  |  110 lines  |  [TEXT/MPS ]
  1. Instructions - The Projector Example
  2.  
  3. Copyright Apple Computer, Inc. 1993
  4. All rights reserved.
  5.  
  6. About the Example
  7.  
  8.     The ProjectorExamples folder contains a project called "Sample".  This
  9.     project contains a file, "Command Pages", and two subprojects: "Utilities"
  10.     and "Commands".  "Utilites" contains two files; "Commands" contains eight.
  11.     If you look at the folder "Sample" with the Finder, all that you will
  12.     see is the file "ProjectorDB" and the folders that represent the two
  13.     subprojects.  Similarly, each subproject folder only appears to 
  14.     contain a "ProjectorDB" file. This is the normal appearance of projects 
  15.     viewed by the Finder.  A project is seen as a folder bearing the project
  16.     name, and containing within it two files: "ProjectorDB", which is visible to
  17.     the Finder, and "__CurUserName", which is invisible.  "ProjectorDB" contains
  18.     all of the project information, including the actual data of the project's
  19.     files.
  20.     
  21.     These instructions will demonstrate how to mount the project, how to
  22.     create a checkout directory structure, how to get information on 
  23.     the projects and files, and how to check out files.  Other Projector
  24.     capabilities can be investigated by following the reference documenta-
  25.     tion, using the project in this Example as a framework for experiment-
  26.     ation.
  27.  
  28. Mounting the Project
  29.  
  30.     You can mount the project "Sample" by executing the following line
  31.     (select the line and press Enter).
  32.          
  33.          MountProject "{MPW}"Examples:ProjectorExamples:Sample
  34.          
  35.     Now, on your Worksheet, execute the command "MountProject" with no
  36.     arguments to demonstrate that "Sample" has been mounted.  Also, execute
  37.     the command "Project" to demonstrate that "Sample∫" is the current project.
  38.  
  39. Creating Checkout Directories
  40.  
  41.     The most common, but not necessarily the only, way to set up Checkout 
  42.     directories is to have their structure mimic that of the project.  To
  43.     do this, first create a top-level folder.  For example, create a new
  44.     folder called "CheckOut" inside the ProjectorExample folder.  This can
  45.     be done as follows--
  46.     
  47.     First make ProjectorExample the current directory
  48.     by executing
  49.         
  50.         Directory "{MPW}"Examples:ProjectorExamples
  51.     
  52.     Then execute
  53.     
  54.          NewFolder CheckOut
  55.          
  56.     Finally, execute the command
  57.     
  58.         CheckOutDir -r CheckOut
  59.     
  60.     You will discover that the folder "CheckOut" now has the same structure
  61.     as the project "Sample".  That is, "CheckOut" contains two folders: 
  62.     "Commands" and "Utilities".  What has happened is that the current project,
  63.     Sample∫, was checked out to the directory "CheckOut".  The option -r
  64.     specified that subprojects should be (recursively) checked out to
  65.     subdirectories, creating the latter if necessary.
  66.  
  67. Check Out/Check In Windows
  68.  
  69.     Go to the Project menu and, in turn, select "Check In…" and "Check Out…".
  70.     You will now see the "Check In" and "Check Out" windows on your desktop.
  71.     For most of this exercise, you will be using the "Check Out" window.
  72.     However, it is instructive to observe how the two windows track each
  73.     other.  Note that "Sample" is shown as the "Current Project" at the top
  74.     left of the "Check Out" window, and that "CheckOut" is shown as the 
  75.     directory to the right of the legend "Checkout to:".  Also note the
  76.     icons for the subprojects "Commands" and "Utilities" and for the file
  77.     "Command Pages".  If you open either subproject by selecting it and
  78.     pressing the "Open" button (or by double-clicking on the subproject),
  79.     you will see the files belonging to that subproject.  Note the change
  80.     in the "Checkout to:" window when a subproject is opened.  Also note
  81.     the changes in the "Check In" window and how they follow those in the
  82.     "Check Out" window.  Observe that you can also select projects by navi-
  83.     gating in the pop-up labelled "Project:" at the top right of the 
  84.     "Check In" window, and that the fields in the "Check Out" window follow
  85.     your selections.
  86.  
  87. Info
  88.  
  89.     Press the button with the big "?" in the "Check Out" window.  Select
  90.     in turn various files and projects and look at the information that
  91.     is presented.  Choose and open a file, e.g. "Command Pages", and ob-
  92.     serve the icons that correspond to the various revisions.  Select
  93.     each revision in turn and again observe the information.  Exit 
  94.     from the Information mode by pressing the "Done" button.
  95.  
  96. Checking Out
  97.  
  98.     Make "Sample" the current project.  Select "Command Pages" and press 
  99.     "Check Out".  Make "Utilities" the current project by opening it.
  100.     Press "Select All" and then press "Check Out".  Do the same with
  101.     "Commands".  When done, you will find that the latest revision of 
  102.     each file in the project has been checked out to the proper folder
  103.     in the directory structure headed by "CheckOut".  If you open any of
  104.     the files, you will discover that they are in a read-only state
  105.     because the "Read-only" radio button in the "CheckOut" window had been
  106.     set.
  107.     
  108.     For further experimentation, e.g. checking out a file for modifica-
  109.     tion, editing it, and checking in a new revision, follow the in-
  110.     structions in the reference manual.